home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / wabird.zip / WABIRD.DOC < prev   
Text File  |  1989-05-18  |  16KB  |  428 lines
  1.  
  2.  
  3.  
  4.                         \\     //
  5.                       ____\   /____                        
  6.                      //~~\\   //~~\\                         
  7.                     ((  _ )}={(  _ ))                        
  8.                      \\(*//   \\(*//  Watch                  
  9.                       ~~~~     ~~~~                     _|   
  10.                                                      -=(~))   
  11.                                                         ||_____|+ 
  12.                                                        (       ) 
  13.                                                         (_____)
  14.                                                           | |
  15.                                                           | +--\
  16.                                                    Bird   /
  17.  
  18.  
  19.                                * WatchBird v1.00 *
  20.                         The ultimate carrier-wise utility
  21.  
  22.                        (C) CopyRight 1989 by Angelo Besani
  23.                     Co-SysOp on <AmnesiA CBCS> Varese - Italy
  24.              (FidoNet 2:331/101.0) 2400,V21,MNP,CM,XA #39-331-263425
  25.         Documentation by Alberto Morosi, SysOp of....well, the same board!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         A  lot  of  SysOps  have always been  complaining  about  the  way 
  68.         carrier  watchers behaved:  rebooting their system without leaving 
  69.         any  chance to save or to preserve what they or their  users  were 
  70.         doing if they were running a multitasking environment.
  71.         As  always  happens,  we never realized how much annoying  it  was 
  72.         until we had to use this system on our board ;-).
  73.         Somebody  gave us WatchKat,  and we used it.  The idea was  really 
  74.         great,  but WaKat did *NOT* exit from COMMAND.COM,  it was a nasty 
  75.         limitation,  so we wanted something more and ...after WatchDog and 
  76.         WatchKat, why not to have also WATCHBIRD???
  77.  
  78.         WatchBird  really  does what any SysOp ever wanted from a  watchcd 
  79.         utility:  it runs outside programs, controls the carrier and if it 
  80.         drops gets back to DOS without rebooting, uses a fossil driver but 
  81.         also  does  something more.  WatchBird will close all  your  files 
  82.         while exiting, avoiding the creation of lost chains; will remember 
  83.         the  status  of your screen and put it back from graphic  to  text 
  84.         mode or vice-versa;  will remember in which directory you were and 
  85.         put you back there; will avoid your machine hanging for an "Abort, 
  86.         Retry,  Ignore?"  request;  will allow you to run programs  either 
  87.         through command.com either spawning them directly.
  88.         WatchBird is the ultimate "carrier-wise" utility!
  89.  
  90.         Now,  after  the  commercial spot (uh!) let's  really  talk  about 
  91.         WatchBird.
  92.         By typing WABIRD HELP on your keyboard you will see:
  93.  
  94.                                    WatchBird v 1.00
  95.         (C) 1989 By Angelo Besani, AmnesiA CBCS 2:331/101 +39-331-263425 *ITALY*
  96.                         Slogan: Do BirdWatching, not hunting!!
  97.  
  98.         Usage: WABIRD [switches..]
  99.         where [Switches..] are:
  100.  
  101.         /COMx  Select com port (x in range 1 thru 9)
  102.         /IOAx  Select serial port I/O address (x is an hex number)
  103.         /WBEx  Wait x seconds before exiting after carrier loss (x in range 0 thru 9)
  104.         /NSR   No Screen Re-Adjusting before exiting WatchBird
  105.         /NDR   No Disk&Directory restoring before exiting WatchBird
  106.         /NFC   No File Closing before exiting WatchBird
  107.         /LDT   Lower DTR after carrier loss
  108.         /PBS   Purge Input&Output Buffers before exiting WatchBird
  109.                (This switch requires a compatible fossil driver)
  110.         /NCE   Intercept DOS critical errors and exit
  111.         /DKS   Disable Keyboard Security (not recommended)
  112.         /DEVx  Redirect StdIn, StdOut, StdErr to device 'x'
  113.         /PRGx  Executes program 'x' instead of COMMAND.COM
  114.         /PRM   Passes rest of line to the program as command line switches
  115.  
  116.         This are all the "amazing" features of this little bird-watcher.
  117.         Now  we  will pass through all them giving a brief  but,  I  hope, 
  118.         quite useful description of their functions.
  119.  
  120.  
  121.  
  122.         WatchBird v1.00                                          Page 1
  123.  
  124.  
  125.  
  126.         WABIRD  can  be invoked by any of the commonly  used  outside  bbs 
  127.         doors  (i.e.  in  Opus-CBCS you may use as a ^OC as any of the  O) 
  128.         options, including the ones of msg and file section).
  129.  
  130.         Examples:
  131.  
  132.         ^OCWABIRD /switches
  133.  
  134.         %
  135.         Outside Dos C:\Opus\Wabird.com /switches
  136.         %
  137.  
  138.         %
  139.         Outside Run C:\Opus\Wabird.com
  140.         %
  141.  
  142.         %
  143.         External Message_Management C:\Opus\Wabird.Com
  144.         %
  145.  
  146.         Let's now analyze each command line switch:
  147.  
  148.  
  149.         /COMx           Select Serial Port (x in range 1 to 9)
  150.  
  151.         Tells to the FOSSIL driver which comm port to reset on exit.  This 
  152.         switch is necessary only if also /PBS (see below) is used.
  153.         Default value= /COM1
  154.  
  155.         /IOAx           Select serial port I/O address (x is an hex number)
  156.  
  157.         This switch is necessary: it specifies the hexadecimal I/O address 
  158.         of the port that WaBird will "watch".
  159.         Default values: /IOA3F8 if /COM1 is specified
  160.                         /IOA2F8 if /COM2 is specified
  161.                         There is no default for different values of /COMx
  162.         So, if you are using COM1 or COM2 you may not specify this switch.
  163.  
  164.         /WBEx           Wait x seconds before exiting on carrier loss
  165.  
  166.         WatchBird has been fully tested under DESQview v2.01 and v2.23.
  167.         Under  v2.23 we have noticed that if carrier dropped while DV  was 
  168.         beep-ing  it sometimes caused the machine to hang.  Setting up  an 
  169.         higher  wait time (x has a range from 0 to 9) you may let DV  stop 
  170.         sending out beeps and allow WatchBird to exit without problems.
  171.         If  you use values different than 0 for this switch,  please  take 
  172.         care  that your modem makes no echo to the characters it  receives 
  173.         (AT  E0  in Hayes mode) because otherwise it may cause  a  strange 
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.         WatchBird v1.00                                          Page 2
  184.  
  185.  
  186.  
  187.         loop: if, for example, the modem would respond NO CARRIER, the DOS 
  188.         would  echo it back to the modem,  that would echo it back to  DOS 
  189.         that would echo it back to the modem and so on....
  190.         The  value  of  this switch represents the  minimum  delay  before 
  191.         exiting  and  may  generate a bit higher time  under  multitasking 
  192.         systems or if there was something being performed by DOS.
  193.         Default value: /WBE2
  194.  
  195.         /NSR            No screen re-adjusting before exiting WatchBird
  196.  
  197.         WatchBird  when  started will memorize the current display  status 
  198.         (40/80 colums, text or graphics etc.) and will by default get back 
  199.         to  that  status when exiting after carrier is dropped or after  a  
  200.         normal  termination.  If you will specify this  switch,  WatchBird 
  201.         will exit WITHOUT returning to the original display status.
  202.  
  203.         /NDR            No Disk&Directory restoring before exiting WaBird
  204.  
  205.         WatchBird  will  by default put you back at the disk and path  you 
  206.         were when invoking it. In fact, this function works on the current 
  207.         drive only.
  208.         Example (* indicates the current drive):
  209.  
  210.         * C:\
  211.           D:\
  212.  
  213.         I invoke WABIRD and then change dir (cd UTILS). I will have:
  214.  
  215.         * C:\UTILS
  216.           D:\
  217.  
  218.         Then I change disk (D:)...
  219.  
  220.           C:\UTILS
  221.         * D:\
  222.  
  223.  
  224.           C:\UTILS
  225.         * D:\TEMP
  226.  
  227.         the  carrier drops (or I simply type EXIT) and WaBird  exits... 
  228.         I will find...
  229.  
  230.         Without /NDR          With /NDR
  231.         * C:\                 C:\UTILS
  232.           D:\TEMP           * D:\TEMP
  233.  
  234.         /NFC            No